Skip to main content
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

XM Directory Lite Basic Overview


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


About XM Directory Lite

XM Directory Lite lets you create and update contact information for use in survey distributions. You can upload contacts to create mailing lists and samples, and these lists can be shared across your organization.

Qtip: XM Directory Lite has some of the same features as XM Directory, with more limited functionality. For an overview of XM Directory, see Getting Started with XM Directory.


Mailing Lists

Mailing lists are lists of contacts used to distribute survey invitations. They contain each contact’s name and email address, in addition to any other information you feel is important to include. The benefit of building a good, detailed contact list is that, in addition to making survey distribution easy, you can save information about your survey-takers ahead of time, and add it to their responses.

Mailing lists are managed on the Directories page, where you can create new lists, create samples of lists, and manage existing lists. Mailing lists can be built by manually typing out contacts within Qualtrics, or importing contacts from a file. See Creating a Mailing List for step-by-step instructions.

Qtip: Setting up contacts is an important step in project configuration. Once you’re finished, check out the Distributions Basic Overview.


Available Contact Fields

Whether you add contacts manually or by uploading a list, it’s important to consider the type of information you want to include about your contacts beforehand. You can add any information you want to your list, but we also have a few default fields you should be careful to name exactly as listed:

  • Email: The contact’s email address. (This field is always required.)
  • FirstName: The contact’s first name.
  • LastName: The contact’s last name.
  • ExternalDataReference: Extra information about the contact. This is most often used to store data such as an employee or student ID. It can be used to log into authenticators.
  • Language: The language the user should see the survey in. This field has a pre-defined set of Available Language Codes. EN, for example, refers to English, while FR refers to French.
  • Phone: The contact’s phone number.
Qtip: If you include these fields in your file, your column titles must perfectly match these names in capitalization and spacing. The only exception is embedded data.

In addition to these default fields, you can add as many custom fields as you want. Examples of fields you might want to add to your list include gender, state, country, occupation, position, supervisor, etc. Once these custom fields are added to your list, they are considered embedded data.

Embedded Data saved in your contact list can be attached to the responses of your contacts. That means before the recipient even starts the survey, you have information stored about them in the response, and don’t have to waste time asking for this information again. To include your custom fields in your reports and downloaded data, you must navigate to the survey flow and add an embedded data element for those fields.

Attention: The character limit for embedded data in XM Directory Lite is 1024 characters.


Creating a Mailing List

  1. Navigate to Directories.
    Topmost hamburg navigation expanded next to XM logo; directories is selected
  2. Go to the Lists tab.
    The lists tab on the upper-left and the Create a list button on the top-right of the page
  3. Click Create a list.
  4. Name your list.
    naming a mailing list

    Qtip: List names are not compatible with some special characters (e.g., =, {}, or <>).
  5. Click Confirm.

Once inside your contact list, you can choose to upload contacts through a file upload or manually. While these pages provide instructions for creating a mailing list in XM Directory, the functionality is the same in XM Directory Lite.



Using Mailing Lists in Distributions

Now that you’ve created your contact list, let’s talk about all the ways you can use them to distribute your surveys.



Managing Contact Lists and Samples

The Directories page isn’t just for making new mailing lists – it’s also for managing the ones you’ve already made. Check out these pages for more information on managing contacts and creating samples.

  • Purchasing Contact Lists / Respondents: Providing panels to researchers has turned into a robust industry. If you’re interesting in purchasing a panel from Qualtrics, reach out to our Research Services team here.
  • Edit Contacts in a Mailing List: Learn to import updates to a mailing list, add more contacts, delete contacts, subscribe and unsubscribe contacts, and consolidate duplicates.
  • Manage Lists: Learn to delete lists, filter list contacts, export lists, share lists, or move lists into folders.
  • Creating Samples: Learn to break existing lists into subsets.


Converting Existing Directories

If you are using XM Directory Lite, but your organization has access to XM Directory, existing directories can be converted to take advantage of the expanded functionality available with XM Directory. This action can only be performed by users with the Manage Directories permission enabled.

pop up about converting a directory

  1. Within the directory you want to convert, navigate to the Directory settings tab.
    convert directory section within the directory settings tab
  2. Scroll down to the Use XM Directory for more advanced features section.
  3. Click Convert.
  4. Click Convert again to confirm.
    pop-up confirmation window for converting to xm directory with a blue Convert button in the bottom right

    Attention: This action cannot be undone.


Projects That Can Use XM Directory Lite Contacts

Qtip: The features discussed in this section are not necessarily included with every license. If you’re interested in getting access, please reach out to your Account Team.

You can use XM Directory Lite to build contact lists and send invitations for several types of Qualtrics projects. However, not every Qualtrics project type is compatible with XM Directory Lite.

XM Directory Lite can be used to send the following:

However, XM Directory Lite contact data is completely separate from the employee / participant information saved in the Employee Directory. That means that data edited in one directory will never affect the other. XM Directory Lite cannot be used to distribute any Employee Experience (EX) projects, including Engagement, Pulse, 360, and more.



FAQs

There are several reasons why your contact list file may not be importing:
  • The file is not saved as a CSV or TSV. Contact list files need to be in CSV or TSV format, not XLXS or anything else.
  • The Email column is missing or is not being recognized.
  • The file is larger than 100 MB.
  • There are values in cells that do not have a column header.
  • There are column headers with no values in the cells beneath them.
For more on troubleshooting CSV/TSV Upload Issues, check out the linked support page.
Extra information (apart from first name, last name, and email) can be stored in your contact list as Embedded Data. Qualtrics will automatically consider any extra columns in your contact list file as Embedded Data. For example, if you add a Gender column to your CSV file and input your contacts’ gender in the cells, this data will be stored within Qualtrics for use in surveys and analysis.
Yes, though there are several considerations:
  • If you change the recipient email address, a new email is not sent, but all future emails (new invitations, reminders, etc.) will go to the updated address.
  • If the respondent has already opened their survey, their survey and collected data will not update with the new information. They will have to be sent a new link.
  • If the respondent has not yet opened their survey, their survey will update with the new information.
No. Qualtrics has a built-in SPAM circuit breaker that will detect if one email is included in a single distribution more than once and only send one email as a result. However, duplicate emails in a contact list can still cause issues with reminders and other features. We advise that you use the Consolidate Duplicates feature to search out and combine multiple entries for the same contact.
No. Contact lists are independent of each other, so unsubscribing or deleting members from one will not unsubscribe or delete members from another. If you would like this functionality, contact your Qualtrics Account Executive to learn more about our XM Directory product.
Only Embedded Data fields that are saved in the Survey Flow are included in the downloaded data. Even if those Embedded Data fields are included in the contact list, if they’re not also set in the Survey Flow, they won’t appear in the downloaded data.

If you forgot to put Embedded Data in the Survey Flow, you can add it to your data retroactively, so long as there are values in the contact list. See the Embedded Data support page for further instruction.

Note that if the contact list information you’re trying to download was not included in the contact list at the time the members took the survey, retroactively adding the Embedded Data fields to the Survey Flow will not add that information to the downloaded data later.
When constructing your email message in the Emails section, you can use piped text to insert contact list values into the email message.
  1. Click on the {a} icon.
  2. Select Contact List Field.
  3. Choose Recipient First Name to include each contact’s first name in the email.
  4. Paste the code wherever you want the first name to appear.
  5. Repeat for any other desired contact list fields.
If you would like to instead pipe in values from custom Embedded Data fields (Job, Address, Date of Hire, etc.), select Embedded Data in Step 2 and then type the exact name of the field as it appears in your contact list.
You will need to change the delimiter of your file. Follow the steps on our CSV/TSV Upload Issues page.
There's possibly extra content or spaces outside of the set columns of the imported file. We recommend deleting any empty columns (or columns with a header but no data), and make sure all columns have a header. If this still does not resolve the issue, we recommend copying and pasting your content into a new, empty CSV file, or highlighting empty columns and pressing Delete to ensure there are no hidden characters.
Look for any trailing/leading spaces next to the email addresses. Spaces aren't readily visible in Excel, but they do invalidate email addresses. Apostrophes can also cause upload issues.
Did you have a RecipientID column in your uploaded file? Qualtrics will not create new contacts if there is a RecipientID column (it will only update existing members); if you are creating a new contact list, make sure you delete this column before trying to import.
You can find instructions for adding Embedded Data from your Contact List on the Embedded Data support page.
See the Panel Company Integration support page.
Yes. For instructions on creating a sample, visit the Contacts Sample support page.
XM Directory Lite is a limited contact distribution feature that lets you upload mailing lists. XM Directory Full (or just XM Directory) can also save contacts and lists, but has many enhanced capabilities beyond this. It is a shared, company-wide database of contacts and their information, with enhanced features like transactions, contact frequency settings, segments, directory-wide distribution reports, and more.

For admins, being able to tell whether or not you have XM Directory Full or XM Directory Lite on your license is easy. Admins of XM Directory have access to many more features than the average XM Directory Lite user, including the Summary tab, the Directory Contacts tab, and Directory Settings.

However, even if you’re not an admin, you can often tell whether you have XM Directory Full or XM Directory Lite in one of the following ways:
  1. In addition to the Segments & lists tab, XM Directory Full users have access to a Distributions tab. XM Directory Lite users do not have this feature. (Note: it is also possible the ability to distribute surveys was revoked for your account. Check one of the surveys in your account - if it has a functioning Distributions tab, you’re an XM Directory Lite user. If it doesn’t, you could still be either.)
  2. XM Directory Lite users cannot have multiple directories. If you see a dropdown at the top of your directory, that means you are definitely an XM Directory Full user.
If you’re still not sure which feature you have, reach out to a Brand Administrator. Brand Administrators who are unsure can reach out to their Account Executive or Customer Success Manager.
There are a few reasons why you may not have access to certain tabs in your Qualtrics account.
  1. If you're working on a survey that's been shared with you and you're missing a tab, it's likely the survey owner did not give you permission to access that tab. Contact the survey owner about receiving access.
  2. Some features require you have certain user permissions before you can use them. Reach out to your Brand Administrator about enabling the correct permissions.
  3. Some features are add-on features not included in standard licenses. Contact your Account Executive if you have questions about what's included in your license.